home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / time.z / time
Text File  |  1998-10-20  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIMMMMEEEE((((1111))))                                                                TTTTIIIIMMMMEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      time - time a command
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ttttiiiimmmmeeee [ ----ffff _f_o_r_m_a_t | ----llll | ----pppp ] command
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _c_o_m_m_a_n_d is executed; after it exits, ttttiiiimmmmeeee prints resource usage
  16.      statistics to standard error.  By default, this report includes the
  17.      elapsed time the command spent running, the CPU time spent in execution
  18.      of the command its reaped children, and the CPU time spent executing
  19.      system code by the command and its reaped children.  Times are reported
  20.      in seconds.
  21.  
  22.      ttttiiiimmmmeeee may be directed to produce other resource usage reports via command
  23.      line options.  Additionally, the environment variable TTTTIIIIMMMMEEEE may be used to
  24.      establish a default report format.  See below for a description of how
  25.      the contents of this report format specification are interpreted.
  26.  
  27. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  28.      ----ffff _f_o_r_m_a_t
  29.           Specify a resource usage report format.  See below for a description
  30.           of how the contents of this string are interpreted.
  31.  
  32.      ----llll   Use a long resource usage report that covers all resource usage
  33.           statistics that are collected.
  34.  
  35.      ----pppp   Use the standard default resource usage report format:
  36.  
  37.              real _e_l_a_p_s_e_d _t_i_m_e
  38.              user _u_s_e_r _C_P_U _t_i_m_e
  39.              sys  _s_y_s_t_e_m _C_P_U _t_i_m_e
  40.  
  41.           This is useful when the TTTTIIIIMMMMEEEE environment variable has been set to
  42.           establish a differnt default resource usage report format.
  43.  
  44. RRRREEEESSSSOOOOUUUURRRRCCCCEEEE UUUUSSSSAAAAGGGGEEEE RRRREEEEPPPPOOOORRRRTTTT FFFFOOOORRRRMMMMAAAATTTT SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  45.      ttttiiiimmmmeeee may be directed to produce a customized resource usage report format
  46.      either via the ----ffff _f_o_r_m_a_t command line option or the TTTTIIIIMMMMEEEE environment
  47.      variable.  In both cases the specified string is scanned for pppprrrriiiinnnnttttffff(3)-
  48.      like percent ("%") escape sequences.  These sequences cause various
  49.      resource usage statistics to be output.  Additionally several backslash
  50.      ("\") escapes are also provided to help in outputting special characters.
  51.      All other non-escape characters are output as is.  The set of escape
  52.      sequences recognized and their interpretations are:
  53.  
  54.      \\\\\\\\   A backslash "\".
  55.  
  56.      \\\\nnnn   A newline.  Note: if the last character output by the format string
  57.           is not a newline, one will be automatically appended.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTIIIIMMMMEEEE((((1111))))                                                                TTTTIIIIMMMMEEEE((((1111))))
  71.  
  72.  
  73.  
  74.      \\\\rrrr   A carriage return.
  75.  
  76.      \\\\tttt   A tab.
  77.  
  78.      \\\\_n_n_n The character corresponding to the octal number _n_n_n which may be up
  79.           to three digits.
  80.  
  81.      %%%%%%%%   A percent sign "%".
  82.  
  83.      %%%%EEEE   The elapsed time.
  84.  
  85.      %%%%UUUU   The user CPU time for _c_o_m_m_a_n_d and all of its children which were
  86.           _r_e_a_p_e_d by _c_o_m_m_a_n_d.  (A child is reaped by calling one of the wwwwaaaaiiiitttt(2)
  87.           system calls.)
  88.  
  89.      %%%%SSSS   The system CPU time for _c_o_m_m_a_n_d and all of its children which were
  90.           _r_e_a_p_e_d
  91.  
  92.      %%%%PPPP   The percent CPU utilization followed by a percent sign "%".  This is
  93.           calculated as (%%%%UUUU+%%%%SSSS)/%%%%EEEE*100.  Note that this percentage can be
  94.           greater that 100% on multiprocessor systems.  This can happen
  95.           because %%%%UUUU and %%%%SSSS include all the CPU time accumulated by _c_o_m_m_a_n_d
  96.           and its reaped children.  Since those children can execute in
  97.           parallel on an MP system, CPU time can accumulate faster than
  98.           elapsed time ...
  99.  
  100.      %%%%RRRR   The number of page faults that resulted in a page being reclaimed
  101.           from the page cache.
  102.  
  103.      %%%%FFFF   The number of page faults that resulted in a page being read from
  104.           disk.
  105.  
  106.      %%%%VVVV   The sum of %%%%RRRR and %%%%FFFF.
  107.  
  108.      %%%%wwww   The number of voluntary context switches.  These result from
  109.           explicit yields via calls to sssslllleeeeeeeepppp(2), ssssggggiiiinnnnaaaapppp(2), etc. and from
  110.           contention on a resource.  High voluntary context switches and large
  111.           amounts of idle time often indicate an MP resource contention
  112.           problem.
  113.  
  114.      %%%%cccc   The number of involuntary context switches.  These result from a
  115.           process being switched out at the end of its CPU time slice or being
  116.           preempted by a higher priority process.
  117.  
  118.      %%%%WWWW   The number of times the process was swapped.  Non-zero values here
  119.           indicate that the system memory is probably desperately
  120.           oversubscribed.
  121.  
  122.      %%%%CCCC   The sum of %%%%wwww, %%%%cccc, and %%%%WWWW.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TTTTIIIIMMMMEEEE((((1111))))                                                                TTTTIIIIMMMMEEEE((((1111))))
  137.  
  138.  
  139.  
  140.      %%%%IIII   The number of disk input operations that were performed for the
  141.           process.  Note that not all rrrreeeeaaaadddd(2) calls result in disk input
  142.           operations.  If the requested data is found in the system buffer
  143.           cache, no disk input operation will be necessary.
  144.  
  145.      %%%%OOOO   The number of disk output operations that were performed for the
  146.           process.  Note that this number is somewhat fuzzy since wwwwrrrriiiitttteeee(2)
  147.           calls are performed asynchronously by copying the requested output
  148.           data into the system buffer cache and scheduling the actual output
  149.           operation to occur at a later time.  If the process exits before the
  150.           actual output operation, it won't be charged against the process.
  151.  
  152.      %%%%????   The sum of %%%%IIII and %%%%OOOO.
  153.  
  154.      %%%%kkkk   The number of signals received by the process.
  155.  
  156. EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
  157.      If the _c_o_m_m_a_n_d is invoked, the exit status of ttttiiiimmmmeeee will be the exit
  158.      status of _c_o_m_m_a_n_d.  ttttiiiimmmmeeee will exit with an exit status of 1-125 if an
  159.      error occurred in the ttttiiiimmmmeeee command itself.  An exit status of 126 will be
  160.      returned if the _c_o_m_m_a_n_d specified was found but could not be invoked.  If
  161.      the _c_o_m_m_a_n_d could not be found, the exit status will be 127.
  162.  
  163. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  164.      TTTTIIIIMMMMEEEE Used to establish a default resource usage report format.  The ----pppp
  165.           option may be used to force the built in default.
  166.  
  167. NNNNOOOOTTTTEEEESSSS
  168.      Users of ccccsssshhhh(1), ttttccccsssshhhh(1), and kkkksssshhhh(1) (and most other shells) beware:
  169.      these shells have builtin ttttiiiimmmmeeee commands which perform the same function
  170.      as ttttiiiimmmmeeee(1) but print the results in a different format.  Also note that
  171.      the ttttiiiimmmmeeee commands in ccccsssshhhh and ttttccccsssshhhh have similar, but not identical output
  172.      formatting capability.
  173.  
  174.      Note that timing shell pipe lines may not produce the results that you
  175.      think they should.  In particular, the Bourne and Korn shells both return
  176.      as soon as the last command in a pipe line terminates.  For instance,
  177.      note that in the second example below, ////bbbbiiiinnnn////ttttiiiimmmmeeee outputs a real time of
  178.      approximately 5 seconds even though the first command in the pipe line
  179.      won't terminate for another 5 seconds.
  180.  
  181.          % /bin/time /bin/sh -c 'sleep 5 | sleep 10'
  182.  
  183.          real 10.100
  184.          user 0.010
  185.          sys  0.040
  186.          % /bin/time /bin/sh -c 'sleep 10 | sleep 5'
  187.  
  188.          real 5.060
  189.          user 0.010
  190.          sys  0.040
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. TTTTIIIIMMMMEEEE((((1111))))                                                                TTTTIIIIMMMMEEEE((((1111))))
  203.  
  204.  
  205.  
  206. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  207.      ccccsssshhhh(1), ttttccccsssshhhh(1), ksh(1), ggggeeeettttrrrruuuussssaaaaggggeeee(2), ppppeeeerrrrffffeeeexxxx(1), ssssssssrrrruuuunnnn(1)*
  208.  
  209.      * The ssssssssrrrruuuunnnn(1) command is part of the SSSSppppeeeeeeeeddddSSSShhhhoooopppp image in the IRIXTM
  210.      Development Option.
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.